home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / b / iktker.hlp < prev    next >
Encoding:
Text File  |  1992-09-29  |  31.5 KB  |  891 lines

  1. )F FUNCTION -
  2.  
  3. HELP revision:   Version 4.2.2  (91/8/19)
  4.  
  5.   The KERMIT command invokes Kermit-TSO, an assembly language program
  6. which implements the Kermit file transfer protocol on IBM System/370
  7. and XA mainframe computers and compatibles running the MVS (Multiple
  8. Virtual Storage) operating system with the TSO (Time Sharing Option)
  9. subsystem.  Kermit-TSO supports file transfer in both line-mode and
  10. full-screen operation.
  11.  
  12.   Line-mode supports asynchronous  half-duplex ASCII communications
  13. through 3705/3725 or equivalent front ends, while full-screen supports
  14. asynchronous full-duplex ASCII communications through the IBM Series/1
  15. running the Yale ASCII Communications System (or equivalent) or various
  16. other converters with graphics throughput option. See the SET CONTROLLER
  17. subcommand for further details.
  18.  
  19. )X SYNTAX -
  20.          KERMIT
  21.  
  22.    Required - None
  23.    Defaults - None
  24.    Note     - The Kermit "?" help feature is available when entering
  25.               Kermit-TSO subcommands.  A subcommand followed by a space
  26.               and a question mark and entered with a carriage return
  27.               will display a brief description of what is expected or
  28.               possible at that point.
  29.  
  30.             - When connecting in line-mode, several flags must first be
  31.               set on the local Kermit.  The following are the defaults
  32.               and other possibilities for those values:
  33.  
  34.               Baud             whatever the site supports
  35.               Data bits        7
  36.               Flow-control     None
  37.               Handshake        XON | None
  38.               Local-echo       on (half-duplex)
  39.               Parity           even | mark | odd
  40.  
  41.             - When connecting in full-screen, several flags must first
  42.               be set on the local Kermit.  The following are the
  43.               defaults and other possibilities for those values:
  44.  
  45.               Baud             whatever the site supports
  46.               Data bits        7 | 8
  47.               Flow-control     XON/XOFF | None
  48.               Handshake        None
  49.               Local-echo       off (full-duplex)
  50.               Parity           even | mark | odd | none
  51.  
  52.             - When sending files to Kermit-TSO, any record longer than
  53.               the logical record length (LRECL) will be truncated or
  54.               folded to the length at the user's discretion.  If the
  55.               record format is fixed (RECFM=F), any shorter records will
  56.               be padded to LRECL.  If the record format is variable or
  57.               undefined (RECFM=V or RECFM=U), the block length can be as
  58.               high as 32760, provided the disk device tracksize is not
  59.               exceeded.
  60.  
  61.             - When sending files to Kermit-TSO, the local Kermit must
  62.               use a carriage return as the end-of-line (EOL) character.
  63.  
  64.             - This version of Kermit-TSO does not support timeouts for
  65.               other than line-mode terminals.  Therefore, the user
  66.               should press the carriage return key on the microcomputer
  67.               after long periods of update inactivity during file
  68.               transfer, or rely on the timeout facility of the local
  69.               Kermit, if supported, to avoid indefinite delays.
  70.  
  71. )O OPERANDS -
  72.          None
  73.  
  74. )S SUBCOMMANDS -
  75.  
  76.          BYE       - logs out other Kermit server.
  77.          CWd       - establishes a new working directory.
  78.          DIRectory - displays all or part of the disk directory.
  79.          ECho      - a line back to the user.
  80.          END       - a Kermit-TSO session
  81.          EXit      - from Kermit-370.
  82.          FINish    - other Kermit server.
  83.          Get       - file(s) from a Kermit server.
  84.          GIve      - saves changes to a translate table.
  85.          Help      - about Kermit-370.
  86.          HOst      - executes a system command.
  87.          Kermit    - executes a Kermit-TSO subcommand.
  88.          LOCal     - executes a Kermit-TSO subcommand.
  89.          Quit      - from Kermit-370.
  90.          RECeive   - file(s) from other Kermit.
  91.          REMote    - send a command to the other Kermit.
  92.          SENd      - file(s) to other Kermit.
  93.          SERver    - mode of remote operation.
  94.          SET       - various parameters.
  95.          SHow      - various parameters.
  96.          STatus    - inquiry.
  97.          STOP      - exit protocol mode.
  98.          TAke      - subcommands from a file.
  99.          TDump     - the contents of a chosen table.
  100.          TSo       - executes a system command.
  101.          TYPE      - a file.
  102.          VErsion   - displays Kermit's version number and date.
  103.          XECHO     - echoes a line (transparently).
  104.          XTYPE     - displays a file (transparently).
  105.  
  106. =BYE
  107. )F FUNCTION -
  108.            Log out a Kermit server on another system.
  109.  
  110. )X SYNTAX -
  111.          BYE
  112.  
  113.    Required - None
  114.    Defaults - None
  115.  
  116. )O OPERANDS -
  117.          None
  118.  
  119. =CWD=CW
  120. )F FUNCTION -
  121.            Set a new prefix for dataset names used by Kermit.
  122.  
  123. )X SYNTAX -
  124.          CWD 'string'
  125.                or
  126.          CWD 'pds-name()'
  127.  
  128.    Required - None
  129.    Defaults - None
  130.    Alias    - SET PREFIX
  131.  
  132. )O OPERANDS -
  133. ))STRING   - Partially qualified DSN.
  134. ))PDS-NAME - Fully qualified DSN of a PDS.  File names are assumed to be
  135.              member names.
  136.  
  137. =DIRECTOR=DIRECTO=DIRECT=DIREC=DIRE=DIR
  138. )F FUNCTION -
  139.            Display dataset names from the catalog.
  140.  
  141. )X SYNTAX -
  142.          DIRECTORY 'string'
  143.  
  144.    Required - None
  145.    Defaults - All datasets belonging to the user.
  146.  
  147. )O OPERANDS -
  148. ))STRING   - Partially qualified DSN.
  149.  
  150. =ECHO=ECH=EC
  151. )F FUNCTION -
  152.            Display a string of text at the terminal.  See also XECHO.
  153.  
  154. )X SYNTAX -
  155.          ECHO 'string'
  156.  
  157.    Required - 'string'
  158.    Defaults - None
  159.  
  160. )O OPERANDS -
  161. ))STRING - Text to be displayed.  May be mixed case.
  162.  
  163. =END
  164. )F FUNCTION -
  165.            Terminate Kermit-TSO and return to TSO prompt.
  166.  
  167. )X SYNTAX -
  168.          END
  169.  
  170.    Required - None
  171.    Defaults - None
  172.    Alias    - EXIT, QUIT
  173.  
  174. )O OPERANDS -
  175.          None
  176.  
  177. =EXIT=EXI=EX
  178. )F FUNCTION -
  179.            Terminate Kermit-TSO and return to TSO prompt.
  180.  
  181. )X SYNTAX -
  182.          EXIT
  183.  
  184.    Required - None
  185.    Defaults - None
  186.    Alias    - END, QUIT
  187.  
  188. )O OPERANDS -
  189.          None
  190.  
  191. =FINISH=FINIS=FINI=FIN
  192. )F FUNCTION -
  193.            Terminate server mode in another Kermit.
  194.  
  195. )X SYNTAX -
  196.          FINISH
  197.  
  198.    Required - None
  199.    Defaults - None
  200.  
  201. )O OPERANDS -
  202.          None
  203.  
  204. =GET=GE=G
  205. )F FUNCTION -
  206.            Request a file from another Kermit running in server mode.
  207.  
  208. )X SYNTAX -
  209.          GET 'foreign-filespec' 'dataset-name'
  210.  
  211.    Required - 'foreign-filespec'
  212.    Defaults - 'dataset-name' will match the 'foreign-filespec'
  213.  
  214. )O OPERANDS -
  215. ))FOREIGN-FILESPEC - The name of a file on the other system.
  216. ))DATASET-NAME     - The name the file is to have on TSO.
  217.  
  218. =GIVE=GIV=GI
  219. )F FUNCTION -
  220.            Save the current contents of a translation table in the form
  221.            of a TAKE file containing SET commands to change the default
  222.            into the current arrangement.
  223.  
  224. )X SYNTAX -
  225.          GIVE 'table-name' 'take-dataset-name'
  226.  
  227.    Required - 'table-name' 'take-dataset-name'
  228.    Defaults - file extension 'TAKE' for the 'take-dataset-name'
  229.  
  230. )O OPERANDS -
  231. ))TABLE-NAME - Specifies the name of the table to save.
  232. ))TAKE-DATASET-NAME - Specifies the dataset in which to save the SET
  233.                       subcommands.  The file extension is automatically
  234.                       supplied as TAKE unless the last qualifier is
  235.                       KERMINI (or the name is fully qualified and
  236.                       quoted).
  237.  
  238. =HELP=HEL=HE=H
  239. )F FUNCTION -
  240.            Display help information about Kermit-TSO subcommands.  This
  241.            is the standard TSO help facility and follows the same rules
  242.            and has the same operands.
  243.  
  244. )X SYNTAX -
  245.          HELP 'subcommand-name' 'operands'
  246.  
  247.    Required - None
  248.    Defaults - None
  249.  
  250. )O OPERANDS -
  251. ))SUBCOMMAND-NAME - Specifies the subcommand name to explain.
  252. ))FUNCTION        - display the function of the subcommand
  253. ))SYNTAX          - display the syntax of the subcommand
  254. ))OPERANDS(LIST)  - display the list of operands
  255. ))ALL             - display all operands
  256.  
  257. =HOST=HOS=HO
  258. )F FUNCTION -
  259.            Execute a TSO command.
  260.  
  261. )X SYNTAX -
  262.          HOST 'command'
  263.  
  264.    Required - 'command'
  265.    Defaults - None
  266.    Alias    - TSO
  267.  
  268. )O OPERANDS -
  269. ))COMMAND - The text to be executed as a command.
  270.  
  271. =KERMIT=KERMI=KERM=KER=KE=K
  272. )F FUNCTION -
  273.            Execute a Kermit subcommand.  This is useful particularly for
  274.            distinguishing Kermit subcommands from TSO commands.
  275.  
  276. )X SYNTAX -
  277.          KERMIT 'subcommand'
  278.  
  279.    Required - 'subcommand'
  280.    Defaults - None
  281.  
  282. )O OPERANDS -
  283. ))SUBCOMMAND - The text to be executed as a Kermit subcommand.
  284.  
  285. =LOCAL=LOCA=LOC
  286. )F FUNCTION -
  287.          Execute a Kermit subcommand.  LOCAL is really a prefix, rather
  288.          than a subcommand, but the effect is the same.  This function
  289.          applies whether Kermit-TSO is operating as a 'local' Kermit or
  290.          not.
  291.  
  292. )X SYNTAX -
  293.          LOCAL 'subcommand'
  294.  
  295.    Required - 'subcommand'
  296.    Defaults - None
  297.  
  298. )O OPERANDS -
  299. ))SUBCOMMAND - The text to be executed as a Kermit subcommand.
  300.  
  301. =QUIT=QUI=QU=Q
  302. )F FUNCTION -
  303.            Terminate Kermit-TSO and return to TSO prompt.
  304.  
  305. )X SYNTAX -
  306.          QUIT
  307.  
  308.    Required - None
  309.    Defaults - None
  310.    Alias    - END, EXIT
  311.  
  312. )O OPERANDS -
  313.          None
  314.  
  315. =RECEIVE=RECEIV=RECEI=RECE=REC
  316. )F FUNCTION -
  317.            Initiates file transfer to Kermit-TSO from the other Kermit.
  318.  
  319.            - If the optional 'dataset-name' is not specified,
  320.              Kermit-TSO will use the name(s) provided by the other
  321.              Kermit.  If no dataset exists with this name, one will
  322.              be created using the file attribute and space values in
  323.              effect when the RECEIVE subcommand was entered.
  324.            - If the 'dataset-name' specified is the same as an existing
  325.              dataset, Kermit-TSO will prompt the user for the option to
  326.              overwrite the dataset.
  327.            - If the 'dataset-name' was not specified, but is the same
  328.              as an existing dataset,  Kermit-TSO will overwrite the
  329.              dataset if FILE COLLISION has been set to OVERWRITE, but
  330.              will attempt to create a new, unique name otherwise.
  331.  
  332. )X SYNTAX -
  333.          RECEIVE 'dataset-name'
  334.  
  335.    Required - None
  336.    Defaults - None
  337.  
  338. )O OPERANDS -
  339. ))DATASET-NAME - Specifies the dataset where the file being received
  340.                  will be written.
  341.  
  342. =REMOTE=REMOT=REMO=REM
  343. )F FUNCTION -
  344.          Send a subcommand for execution to the other Kermit, operating
  345.          in server mode.  See under SERVER for a list of the allowed
  346.          subcommands.  REMOTE is really a prefix, rather than a
  347.          subcommand, but the effect is the same.  Note that REMOTE PRINT
  348.          supports the same options as SEND in connection with the
  349.          filespec.
  350.  
  351. )X SYNTAX -
  352.          REMOTE 'subcommand'
  353.  
  354.    Required - 'subcommand'
  355.    Defaults - None
  356.  
  357. )O OPERANDS -
  358. ))SUBCOMMAND - The text to be executed by the Kermit server.
  359.  
  360. =SEND=SEN
  361. )F FUNCTION -
  362.            Initiates file transfer from Kermit-TSO to the other Kermit.
  363.  
  364.            - One wildcard '*' may be used anywhere in the 'dataset-name'
  365.              or in the PDS member name, if any, to stand for a string of
  366.              zero or more characters.
  367.            - The 'dataset-name' must be cataloged.
  368.  
  369. )X SYNTAX -
  370.          SEND 'dataset-name' 'foreign-filespec', ...
  371.  
  372.    Required - 'dataset-name'
  373.    Defaults - Will prompt for both if neither is supplied.
  374.  
  375. )O OPERANDS -
  376. ))DATASET-NAME   - The name of the dataset(s) to be sent.  You may
  377.                    append a range of line numbers within angle brackets.
  378.                    Only those lines, inclusive, will be sent.  Also,
  379.                    optionally, column-one ASA carriage control may be
  380.                    converted to formatting control characters via the CC
  381.                    option.  E.g., SEND FOO.BAR<9-15> will send only
  382.                    lines nine through fifteen of the dataset; SEND
  383.                    FOO.BAR<9-15_CC> will also convert the carriage
  384.                    control.  Note that the underscore marks the end of
  385.                    the optional line range and may not be omitted if an
  386.                    option (such as CC) is to be specified.
  387.  
  388. ))FOREIGN-FILESPEC - The name the file is to have on the other system.
  389.  
  390. =SERVER=SERVE=SERV=SER
  391. )F FUNCTION -
  392.            Invokes Kermit-TSO server mode.
  393.  
  394.            - Once Kermit-TSO enters server mode, it only accepts
  395.              subcommands entered at the local Kermit until a FINISH
  396.              command is executed.  Any non-default parameters must be
  397.              SET before invoking this mode if the local Kermit does
  398.              not offer the REMOTE KERMIT function.
  399.            - The local Kermit must support server subcommands to
  400.              communicate with Kermit-TSO in this mode.  The basic
  401.              server subcommands are GET, SEND, BYE, and FINISH, but
  402.              Kermit-TSO supports others as well:
  403.  
  404.              BYE          - End server mode, end Kermit-TSO, and logoff;
  405.              FINISH       - End server mode and return to the
  406.                             Kermit-TSO prompt;
  407.              GET          - Get a file from Kermit-TSO;
  408.              REMOTE COPY  - Copy a file or files under TSO;
  409.              REMOTE CWD   - Set new Kermit DSN prefix;
  410.              REMOTE DIR   - Display list of datasets;
  411.              REMOTE ERASE - Delete a dataset;
  412.              REMOTE HELP  - Display this command summary;
  413.              REMOTE HOST  - Execute a TSO command;
  414.              REMOTE KERMIT- Execute a Kermit-TSO subcommand;
  415.              REMOTE PRINT - Send a file to be printed from TSO;
  416.              REMOTE RENAME- Rename a dataset;
  417.              REMOTE TYPE  - Display a dataset;
  418.              SEND         - Send a file to Kermit-TSO.
  419.  
  420.            - Kermit-TSO can execute these subcommands when dealing with
  421.              a remote (server) Kermit.
  422.  
  423. )X SYNTAX -
  424.          SERVER
  425.  
  426.    Required - None
  427.    Defaults - None
  428.  
  429. )O OPERANDS -
  430.          None
  431.  
  432. =SET
  433. )F FUNCTION -
  434.            Modify parameters for file transfer.  The SHOW subcommand
  435.            may be used to examine these values.
  436.  
  437. )X SYNTAX -
  438.          SET 'parameter' 'sub-parameter' 'value'
  439.  
  440.    Note: Many of the parameters are multi-level, as in SET FILE RECFM F.
  441.          The following list of operands includes all levels.
  442.  
  443.    Required - 'parameter'
  444.    Defaults - None
  445.  
  446. )O OPERANDS -
  447. ))ATOE 'num1' 'num2' - Modifies the ASCII-to-EBCDIC translate table
  448.                        used by Kermit-TSO.  The table begins as the
  449.                        Kermit standard translate table (defined in
  450.                        the Kermit protocol specifications).  If the
  451.                        numeric values are omitted, the whole table is
  452.                        restored to its initial contents.  Tables ETOA,
  453.                        TATOE, and TETOA may be modified in the same way.
  454.        'num1' - A decimal number 0-255 for the value of the ASCII
  455.                 character, i.e., the table offset.
  456.        'num2' - A decimal number 0-255 for the corresponding EBCDIC
  457.                 character.
  458.  
  459. ))ATTRIBUTE 'attrib' 'ON | OFF' - Allows suppressing the exchange of
  460.                          attribute packets or individual attributes.
  461.          'attrib' - Optional name of specific attribute to suppress or
  462.                     enable.  Enter "SET ATT ? ?" for a list of them.
  463.  
  464. ))BLKSIZE 'number' - With FILE: specifies the block size for datasets
  465.                      created by Kermit-TSO.  Maximum is 32760.  The
  466.                      default is 6233.
  467.  
  468. ))BLOCK '1 | 2 | 3' - Specifies the type of block check used during
  469.                       file transfer.  The default is 1.
  470.                       '1' - A one character checksum.
  471.                       '2' - A two character checksum.
  472.                       '3' - A three character CRC.
  473.  
  474. ))CHARACTER-SET 'name' - With FILE: specifies set to use for storing TEXT
  475.                       datasets; with TRANSFER: specifies set to use for
  476.                       transfers.
  477.  
  478. ))COLLISION 'APPEND | BACKUP | DISCARD | OVERWRITE | RENAME' -with FILE:
  479.              Tells what to do with an incoming file with the same name
  480.              as an existing dataset.  BACKUP and RENAME are the same
  481.              except that the first renames the existing dataset instead
  482.              of the new one.  In renaming, Kermit-TSO attempts to find a
  483.              unique name by appending a digit to the second qualifier of
  484.              the dataset name.  The default is OVERWRITE.
  485.  
  486. ))CONTROLLER 'TTY | SERIES1 | GRAPHICS | VTAMTTY | AEA' -
  487.              Kermit-TSO automatically determines whether you are
  488.              connected via a Series/1-style emulation controller or a
  489.              TTY line.  This command is provided, though, so you can
  490.              change connections and because Kermit may not be able to
  491.              distinguish between Series/1 and graphics throughput
  492.              devices.  For both those and the 3174 AEA, Kermit attempts
  493.              to disable the 3270 protocol conversion function by putting
  494.              the controller into "transparent mode"; this allows Kermit
  495.              packets to pass through intact.  The value VTAMTTY would be
  496.              specified (and is the default) for any TTY device connected
  497.              through VTAM/TSO.
  498.  
  499. ))DEBUG 'ON | OFF | RAW | I/O | LONG | TIME' -
  500.           If ON, keep a journal of all packets sent and received in the
  501.           file KER.LOG.  If OFF, stop logging the packets and close the
  502.           file.  Default is OFF.  ON may be modified by RAW, I/O, and/or
  503.           LONG.  If RAW, record packets exactly as sent and received,
  504.           rather than in EBCDIC.  If I/O, record supplemental info about
  505.           transfer I/O (for fullscreen devices).  LONG is the same as
  506.           I/O, except that I/O records are not truncated at 36 bytes.
  507.           If TIME and I/O, the extra log records are given time tags.
  508.  
  509.     Note: KER.LOG is prefixed with the Kermit, not the TSO, prefix when
  510.           debug mode is entered.  The log dataset thus begun continues
  511.           in use no matter what happens to the Kermit prefix.
  512.  
  513.     Note: Packets sent by Kermit-TSO are distinguished by a carriage
  514.           return (X'0D') at the end; packets received have had it
  515.           stripped by the front end (TTY) processor.
  516.  
  517. ))DELAY 'number' - Specifies the number of seconds Kermit-TSO will delay
  518.           before beginning to send packets after the SEND subcommand has
  519.           been entered.  Default is 10.  Use a DELAY of 1 to abbreviate
  520.           the usual greetings written on the screen at the start of
  521.           protocol mode or a DELAY of 0 to suppress the greetings
  522.           entirely (along with the attendant one-second pause).
  523.  
  524. ))DELIM 'char' - Specifies a character to be interpreted by Kermit as a
  525.          line delimiter in subsequent subcommands entered from the
  526.          terminal.  The default is none.
  527.  
  528. ))ECHO 'ON | OFF' - With TAKE:
  529.          Controls whether the contents of TAKE command files are echoed
  530.          during execution.
  531.  
  532. ))END-OF-LINE 'number' - With SEND or RECEIVE:
  533.                  Specifies the decimal value of the ASCII character used
  534.                  for the packet-terminator or end-of-line. The 'number'
  535.                  must be 0-31.  The default is carriage return (13).
  536.  
  537. ))EOF 'ON | OFF' - ON means incoming text files are to be cut off at the
  538.           first Ctrl-Z character within the data; OFF means accept
  539.           incoming text files in their entirety.
  540.  
  541. ))ERROR-ACTION 'CONTINUE | HALT' - With TAKE:
  542.                    Controls whether an error occuring during execution
  543.                    of a TAKE command file is fatal to the execution of
  544.                    that file.
  545.  
  546. ))ETOA 'num1' 'num2' - Modifies the EBCDIC-to-ASCII translate table used
  547.                by Kermit-TSO.  See the description under ATOE.
  548.  
  549. ))FILE - Takes subparameters BLKSIZE, CHARACTER-SET, COLLISION, LRECL,
  550.          OVERWRITE, RECFM, SPACE, TYPE, UNIT, and VOLUME.
  551.  
  552. ))FOREIGN - Takes subparameters PREFIX and SUFFIX.
  553.  
  554. ))HANDSHAKE 'number' - Specifies an ASCII code for a handshake character
  555.                 to be appended to each outgoing packet.  Zero means no
  556.                 handshake at all.
  557.  
  558. ))INCOMPLETE 'KEEP | DISCARD' -
  559.          Specifies the action to take when a file transfer is cancelled.
  560.  
  561. ))INITIAL 'num' - With RETRY:
  562.                    Establishes the limit for retrying the first packet
  563.                    in a transfer.  The default is 16.
  564.  
  565. ))LEFT 'column' - With MARGIN: sets the left margin for restricting the
  566.                 width of files to be sent. A value of zero disables the
  567.                 left margin.
  568.  
  569. ))LONGLINE 'TRUNC | FOLD | HALT' - With FILE:
  570.                 Specifies the action to take when a record is received
  571.                 that is too long.  The default is TRUNC.
  572.  
  573. ))LRECL 'number' - With FILE: Specifies the logical record length for
  574.                    incoming datasets.  The 'number' must be from 1 to
  575.                    32760 decimal (32K-8).  The default is 80.
  576.  
  577. ))MARGIN - Takes subparameters LEFT and RIGHT.
  578.  
  579. ))OVERWRITE 'DEFAULT | PRESERVE' - With FILE:
  580.              Specifies whether to retain the original DCB attributes or
  581.              to use the current Kermit defaults when overwriting an
  582.              existing dataset.
  583.  
  584. ))PACKET 'num' - With RETRY:
  585.                    Establishes the limit for retrying a packet in a
  586.                    transfer.  The default is 5.
  587.  
  588. ))PACKET-SIZE 'num' - With RECEIVE:
  589.           Use the specified 'num' as the maximum length for incoming
  590.           packets.  The valid range is 26-9024, and 80 is the default.
  591.           SET RECEIVE PACKET-SIZE 95 or greater causes Kermit-TSO to
  592.           negotiate reception of extended length packets with other
  593.           Kermit programs that support this option.
  594.  
  595. ))PAD-CHAR 'num' - With SEND or RECEIVE:
  596.           Padding character to use between packets, NUL (ASCII 0) by
  597.           default.
  598.  
  599. ))PADDING 'num' - With SEND or RECEIVE:
  600.           Number of copies of the interpacket padding character, zero by
  601.           default.
  602.  
  603. ))PARITY 'MARK | NONE' - With SEND or RECEIVE:
  604.           Transparent-mode ASCII data from a SERIES1 or GRAPHICS device
  605.           will typically have either all Mark parity (seven data bits
  606.           with the eighth bit set) or no parity (eight data bits).
  607.           Kermit-TSO must know which kind of parity to expect in order
  608.           to calculate checksums properly.
  609.  
  610. ))PREFIX 'string' - The specified string is used as the DSN prefix for
  611.           Kermit.  See the CWD subcommand.
  612.  
  613. ))PREFIX 'string' - With FOREIGN:
  614.           The specified string is added to the beginning of outbound
  615.           filespecs.
  616.  
  617. ))PROMPT 'string' - Defines the character string that Kermit-TSO
  618.           displays when asking for a command.  The prompt may be any
  619.           string of up to 20 characters.  The default is "Kermit-TSO>".
  620.  
  621. ))QUOTE 'char' - With SEND or RECEIVE:
  622.                  Control character quoting prefix, normally #.
  623.                  This character must have an ASCII value in the
  624.                  range 33-62 or 96-126.
  625.           Note:  Do not change this parameter unless transferring
  626.                  a long file which contains many '#' characters.
  627.  
  628. ))RECFM 'F | V | U' - With FILE:
  629.             Specifies the record format for new files.  Default is V.
  630.                       F - Fixed (MVS RECFM=FB)
  631.                       V - Variable (MVS RECFM=VB)
  632.                       U - Undefined (MVS RECFM=U)
  633.  
  634. ))RETRY - Takes subparameters INITIAL and PACKET.
  635.  
  636. ))RIGHT 'column' - With MARGIN: sets the right margin for restricting
  637.               the width of files to be sent. A value of zero disables
  638.               the right margin.
  639.  
  640. ))SERVER-TIMEOUT 'num' - Number of seconds to wait for a packet in the
  641.               server loop before sending a NAK.  Default is 120.
  642.  
  643. ))SPACE 'number' - With FILE: Specifies the number of tracks for the
  644.               space allocation for new files being received from the
  645.               local Kermit.  Default is 5.
  646.  
  647. ))SPEED 'number' - Specifies the line speed assumed in the packet-size
  648.               optimization algorithm.
  649.  
  650. ))START-OF-PACKET 'num' - With SEND or RECEIVE:
  651.                 Control character to mark start of packet, normally
  652.                 Ctrl-A (ASCII 1).  May be 0-31.
  653.  
  654. ))SUFFIX 'string' - With FOREIGN:
  655.                    The specified string is added to the end of outbound
  656.                    filespecs.
  657.  
  658. ))SYSCMD 'ON | OFF' -
  659.                    Determine whether non-Kermit commands are assumed to
  660.                    be TSO commands and passed to TSO for execution.
  661.  
  662. ))TABS 'OFF | ON | ON,tab-list' - Enables or disables tab expansion for
  663.                                   files being received. Default is OFF.
  664.                 OFF         - Disables expansion.
  665.                 ON          - Enables expansion and specifies tabs at
  666.                               columns 9, 17, 25, etc.
  667.                 ON,tab-list - Enables expansion and specifies use of
  668.                               tab stops listed in 'tab-list'.
  669.  
  670. ))TAKE - Takes subparameters ECHO and ERROR-ACTION.
  671.  
  672. ))TATOE 'num1' 'num2' - Modifies the ASCII-to-EBCDIC translate table
  673.                         used by Kermit-TSO.  See the description under
  674.                         ATOE.
  675.  
  676. ))TEST 'ON | OFF' - Used for testing new versions, suppresses block
  677.           check verification, allows start-of-packet to be set to
  678.           anything at all.  The default if OFF.
  679.  
  680. ))TETOA 'num1' 'num2' - Modifies the EBCDIC-to-ASCII translate table
  681.           used by Kermit-TSO.  See the description under ATOE.
  682.  
  683. ))TIMEOUT 'num' - With SEND or RECEIVE:
  684.                    Number of seconds to wait for a packet before
  685.                    retransmitting.
  686.  
  687. ))TTABLE 'ON | OFF | KP' - Controls whether ATOE/ETOA or TATOE/TETOA
  688.           are used for counteracting the system translations on TTY
  689.           lines.  The default is OFF (use ATOE/ETOA).  KP is like ON,
  690.           but also sets the TATOE/TETOA tables to values based on
  691.           Hollerith codes.
  692.  
  693. ))TYPE 'Binary | Text | V-binary | D-binary' - With FILE:
  694.                    Specifies the file type of the data and determines
  695.                    the type of translation, if any, to use.
  696.         Binary   - Specifies non-delimited, bit-stream data.  No trans-
  697.                    lation is performed, and no carriage return/linefeed
  698.                    pairs are added to outgoing records.  Incoming bytes
  699.                    are added successively to the current record, which
  700.                    is written out when the specified logical record
  701.                    length (LRECL) is reached.
  702.         Text     - Specifies textual data.  ASCII-to-EBCDIC and
  703.                    EBCDIC-to-ASCII translation is performed on the
  704.                    data using the defined translate tables.  Carriage
  705.                    return/linefeed pairs are used to delimit the
  706.                    records.  This is the default.
  707.         V-binary - Specifies variable-length binary records.  Like
  708.                    BINARY, except that a 2-byte length field precedes
  709.                    each outbound record and is assumed for incoming
  710.                    records.  Incoming records are stripped of their
  711.                    prefixes and written out when the prefix value is
  712.                    reached.  This is useful when the record format is
  713.                    unformatted (RECFM=U) or variable (RECFM=V).
  714.         D-binary - Specifies variable-length binary records.  Like
  715.                    V-BINARY, except that the prefix field is a 5-byte
  716.                    ASCII decimal string.
  717.  
  718. ))UNIT 'name' - With FILE:
  719.                    Specifies the name of the device type or class for
  720.                    storing new files (e.g., received from the local
  721.                    Kermit).  The default is SYSDA.
  722.  
  723. ))VOLUME 'name' - With FILE:
  724.                    Specifies the name of the particular storage volume
  725.                    for storing new files (e.g., received from the local
  726.                    Kermit).  The default is blank (the system will
  727.                    choose any volume of the specified UNIT class).
  728.  
  729. ))8-BIT-QUOTE 'ON | OFF | char' -
  730.                    Controls whether eighth-bit prefixing is done and
  731.                    specifies the character to be used.
  732.  
  733. =SHOW=SHO=SH
  734. )F FUNCTION -
  735.            Displays the values of all parameters which can be changed
  736.            with the SET subcommand, except the translation tables.
  737.            See also the TDUMP subcommand.
  738.  
  739. )X SYNTAX -
  740.          SHOW 'parameter'
  741.  
  742.    Required - none
  743.    Defaults - all
  744.  
  745. )O OPERANDS -
  746. ))PARAMETER - The parameter whose value is to be displayed.  If the
  747.             value is 'ALL' or is omitted, the values of all parameters
  748.             except the Attribute flags are displayed.  If only one level
  749.             of a multi-level parameter family is given, then all sub-
  750.             parameters will be displayed.
  751.  
  752. =STATUS=STATU=STAT=STA=ST
  753. )F FUNCTION -
  754.            Returns the status of the previous subcommand.  The response
  755.            will display the statistics of the last transfer plus the
  756.            message 'No Errors' or the last error encountered.
  757.  
  758. )X SYNTAX -
  759.          STATUS
  760.  
  761.    Required - None
  762.    Defaults - None
  763.  
  764. )O OPERANDS -
  765.          None
  766.  
  767. =STOP
  768. )F FUNCTION -
  769.          Returns immediately from protocol mode, thereby canceling any
  770.          active transfer and ending server mode if necessary.
  771.  
  772. )X SYNTAX -
  773.          STOP
  774.  
  775.    Required - None
  776.    Defaults - None
  777.  
  778. )O OPERANDS -
  779.          None
  780.  
  781. =TAKE=TAK=TA
  782. )F FUNCTION -
  783.            Executes Kermit-TSO subcommands from the specified file.
  784.  
  785. )X SYNTAX -
  786.          TAKE 'take-dataset-name'
  787.  
  788.    Required - 'take-dataset-name'
  789.    Defaults - None
  790.  
  791. )O OPERANDS -
  792. ))TAKE-DATASET-NAME - Specifies the dataset from which to get the
  793.                       sequence of Kermit-TSO subcommands to execute.
  794.                       The file extension is automatically supplied as
  795.                       TAKE unless the last qualifier is KERMINI (or
  796.                       the name is fully qualified and quoted).
  797.  
  798. =TDUMP=TDUM=TDU=TD
  799. )F FUNCTION -
  800.            Display the contents of the specified table.
  801.  
  802. )X SYNTAX -
  803.          TDUMP 'table-name'
  804.  
  805.    Required - 'table-name'
  806.    Defaults - None
  807.  
  808. )O OPERANDS -
  809. ))TABLE-NAME - Specifies the name of the table to display.
  810.  
  811.      ATOE    - The ASCII-to-EBCDIC translate table.
  812.      ETOA    - The EBCDIC-to-ASCII translate table.
  813.      NAMES   - The list of datasets from the last transfer, i.e.,
  814.                the transaction log.
  815.      TATOE   - The ASCII-to-EBCDIC table (for undoing the front end).
  816.      TETOA   - The EBCDIC-to-ASCII table (for undoing the front end).
  817.  
  818. =TSO=TS
  819. )F FUNCTION -
  820.            Execute a TSO command.
  821.  
  822. )X SYNTAX -
  823.          TSO 'command'
  824.  
  825.    Required - 'command'
  826.    Defaults - None
  827.    Alias    - HOST
  828.  
  829. )O OPERANDS -
  830. ))COMMAND - The text to be executed as a command.
  831.  
  832. =TYPE
  833. )F FUNCTION -
  834.         Display the specified file at your terminal.  Requires the
  835.         existence of a TSO LIST command.
  836.  
  837. )X SYNTAX -
  838.          TYPE 'dataset-name'
  839.  
  840.    Required - 'dataset-name'
  841.    Defaults - None
  842.  
  843. )O OPERANDS -
  844. ))DATASET-NAME - Specifies the file to be displayed.
  845.  
  846. =VERSION=VERSIO=VERSI=VERS=VER=VE
  847. )F FUNCTION -
  848.         Displays the version number and date of Kermit-TSO.
  849.  
  850. )X SYNTAX -
  851.          VERSION
  852.  
  853.    Required - None
  854.    Defaults - None
  855.  
  856. )O OPERANDS -
  857.          None
  858.  
  859. =XECHO=XECH=XEC=XE
  860. )F FUNCTION -
  861.         Display a string of text as a raw text transfer according to the
  862.         current CONTROLLER setting (similar to ECHO).
  863.  
  864. )X SYNTAX -
  865.          XECHO 'string'
  866.  
  867.    Required - 'string'
  868.    Defaults - None
  869.  
  870. )O OPERANDS -
  871. ))STRING - Text to be displayed.  May be mixed case.  May contain
  872.            ASCII control characters using the '^' notation.
  873.  
  874. =XTYPE=XTYP=XTY=XT
  875. )F FUNCTION -
  876.         Display the specified file at your terminal as a raw download
  877.         according to the current CONTROLLER setting.
  878.         See also TYPE.
  879.  
  880. )X SYNTAX -
  881.          XTYPE 'dataset-name'
  882.  
  883.    Required - 'dataset-name'
  884.    Defaults - None
  885.  
  886.    Options may be given in angle brackets <> the same as for SEND.
  887.  
  888. )O OPERANDS -
  889. ))DATASET-NAME - Specifies the file to be displayed.
  890.  
  891.